• A5_DESIGN_BITMAP Function
• A5_GET_BITMAP Function
• A5_GET_BMP_FROM_FILE Function
• A5_GET_JPEG Function
• A5_IMAGE_TRANSFORM Function
• a5_ink_to_png Function
• BITMAP Function
• BITMAP_ALPHA Function
• BITMAP_COLORS_GET Function
• BITMAP_HEIGHT Function
• BITMAP_SATURATION Function
• BITMAP_SIZE Function
• Bitmap_to_JPEG Function
• BITMAP_TO_PALETTE_PNG Function
• BITMAP_TO_PNG Function
• BITMAP_TRANSLUCENT Function
• BITMAP_WIDTH Function
• CHANGE_COLOR Function
• CLIP_SHAPE Function
• Displaying and Printing Bitmaps
• DRAW_BOX Function
• DRAW_WRAP_SCRIPT Function
• DRAW_WRAP_TEXT Function
• EXTENT_HEIGHT Function
• EXTENT_WIDTH Function
• FILL_OVAL Function
• FILL_PIE Function
• FILL_POLY Function
• FILL_RECT Function
• FILL_ROUND_RECT Function
• FILL_SHAPE Function
• INNER_OVAL Function
• INNER_PIE Function
• INNER_POLY Function
• INNER_RECT Function
• INNER_ROUND_RECT Function
• INNER_SHAPE Function
• JPEG_TO_BITMAP Function
• LINE Function
• LINETO Function
• OVAL Function
• PIE Function
• PNG_TO_BITMAP Function
• POLY Function
• POLY_BEZIER Function
• RECT Function
• ROUND_RECT Function
• SET_FONT Function
• SET_ORIGIN Function
• SET_ROTATE Function
• SET_SCALE Function
• SET_UNITS Function
• SHAPE Function
• START_POLY Function
• TEXT Function
• TEXT_HEIGHT Function
• TEXT_WIDTH Function
• UI_BITMAP_CREATE Function
• UI_BITMAP_CREATE_FROM_SCREEN Function
• UI_BITMAP_CREATE_FROM_XPM Function
• UI_BITMAP_DRAW Function
• UI_BITMAP_DROP Function
• UI_BITMAP_INFO_GET Function
• UI_BITMAP_LOAD Function
• UI_BITMAP_PNG_LOAD Function
• UI_BITMAP_PNG_SAVE Function
• UI_BITMAP_SAVE Function
• UI_PRINTER_DRAW Function
• UI_SCREEN_DRAW Function
• UI_SHAPE_DESTROY Function
• UI_SHAPE_LINETO Function
• UI_SHAPE_OVAL Function
• UI_SHAPE_POLY Function
• UI_SHAPE_RECT Function
• UI_SHAPE_ROUND_RECT Function
• UI_SHAPE_START_POLY Function
• WINDOW_TO_IMAGE Function
• WRAP_TEXT_HEIGHT Function

UI_SHAPE_RECT Function

Syntax

Arguments

shape

The name of a new or existing shape.

x

The horizontal coordinate of the upper left corner of the rectangle. Larger values move right.

y

The vertical coordinate of the upper left corner of the rectangle. Larger values move down.

width

The width of the rectangle.

height

The height of the rectangle.

shape_operation

Optional. Default = erase previous shape. An indication of how to combine the shape with other shapes.

"and" = show only the intersection of the rectangle and any other shapes.

"or" = show both the union of the rectangle and any other shapes.

"xor" = show both the rectangle and any other shapes, but do not show their intersection.

Description

The UI_SHAPE_RECT() function draws a rectangle into the shape buffer. You can then use the shape buffer:

to define a new object to write to the bitmap, or

with the CLIP_SHAPE()to limit the portion of the bitmap that can be written on.

Example

This example uses a rectangular shape to limit the drawing region.

ui_bitmap_load("stone", file.to_blob("C:\WINDOWS\Greenstone.bmp"))
ui_bitmap_create("test", 4, 2)
ui_shape_rect("rect", 0, 0, 2, 1)
ui_bitmap_draw("test", <<%code%
inner_rect(0, 0, 4, 2)
clip_shape("rect", 1, .5)
bitmap("stone", 0, 0, 4, 2)
%code%)
ui_dlg_box("", "{image=test}")

This example creates a rectangular shape and draws it onto the bitmap. The border color is set by the current pen. There is no fill.

ui_bitmap_load("stone", file.to_blob("C:\WINDOWS\Greenstone.bmp"))
ui_bitmap_create("test", 4, 2)
ui_shape_rect("rect", 0, 0, 2, 1)
ui_bitmap_draw("test", <<%code%
inner_rect(0, 0, 4, 2)
clip_shape("rect", 1, .5)
bitmap("stone", 0, 0, 4, 2)
%code%)
ui_dlg_box("", "{image=test}")

This example creates a rectangular shape and draws it onto the bitmap. The border color is set by the current pen. There is no fill.

ui_bitmap_create("test", 4, 2)
ui_shape_rect("rect", 0, 0, 2, 1)
ui_bitmap_draw("test", <<%code%
inner_rect(0, 0, 4, 2)
set_pen("black")
set_brush("green")
shape("rect", 1, .5)
%code%)
ui_dlg_box("", "{image=test}")

Limitations

This function is only used in the Code sections of UI_BITMAP_DRAW(), UI_SCREEN_DRAW(), and UI_PRINTER_DRAW().

See Also

• Bitmap and Graphic Functions